XIQS Create Active Device

From IQsimWiki

Jump to: navigation, search

XIQS Create Active Device - GSM Device Management

Description
createXIQSActiveDevice ( [Long id_partition] , String serial_number , Integer initial_status [, String register_name [, String name ] ] )
Create a new GSM Active Device.
Parameters

Long id_partition

Partition id - mandatory if user is administrator

String serial_number

Device serial number

Integer initial_status

Device initial status (Validated/Not validated (dev_status=3 for not validated, dev_status=0 for validated))

[ String register_name ]

GSM device registration name

[ String name ]

GSM device name.



If optional parameters are omitted, device will be created without these parameters. If name parameter exist then it will be set as GSM device name. If register_name exist, then device will be created with this registration name and GSM device name will be string created as concatenated register_name + serial_number.


Return Values
Long id_device
Device Id

Error Data structure ( Error Management )

Possible failure code returns
*ERR_OBJECT_EXISTS(451) ERR_MSG_DVC_FOUND
*ERR_SRV_INTERNAL (500) ERR_MSG_NO_DB or ERR_MSG_OBJ_NO_ID
Example

[REQUEST 1]
<?xml version="1.0" encoding="UTF-8"?>
<command name="createXIQSActiveDevice">
  <param type="long">2</param>
  <param type="string">12345678</param>
  <param type="long">3</param>
  <param type="string">RegisterName</param>
  <param type="string">DeviceName</param>
</command>

will create new device with serial number 12345678, on partition 2, with initial status 3 (not validated), with registration name RegisterName and with name DeviceName


[REQUEST 2]
<?xml version="1.0" encoding="UTF-8"?>
<command name="createXIQSActiveDevice">
  <param type="long">2</param>
  <param type="string">12-34-56</param>
  <param type="long">3</param>
  <param type="string">TestDevice</param>
</command>

will create new device with serial number 12-34-56, on partition 2, with initial status 3 (not validated), with registration name TestDevice and with name TestDevice12-34-56


[REQUEST 3]
<?xml version="1.0" encoding="UTF-8"?>
<command name="createXIQSActiveDevice">
  <param type="long">2</param>
  <param type="string">12-32</param>
  <param type="long">3</param>
</command>

will create new device with serial number 12-32, on partition 2, with initial status 3 (not validated), without registration name and name
Personal tools
Namespaces
Variants
Views
Actions
Navigation
XIQS XML Protocol
XIQS Framework Libraries
XIQS Command List